Skip to main content

OpenAI Cost Exports with nOps Platform

To integrate OpenAI with nOps BC+, follow these steps:

  1. Create an Admin API Key in OpenAI
  2. Set Up Integration in nOps Platform
  3. Verify Integration

Prerequisites​

Before setting up the integration, ensure you have:

  1. OpenAI Account

    • Active OpenAI account with API access
    • Admin access to create Admin API keys

  2. Required Permissions

    • Ability to create Admin API keys with billing data access
    • Permission to view organization settings

  3. Required Information

    • OpenAI Admin API key with appropriate permissions
    • Understanding of which OpenAI services you want to track

Accessing Business Context Integrations​

To begin, navigate to the Organization Settings and click on Integrations. From there, select Business Contexts to proceed with setting up your OpenAI integration.

Below is an example of the integrations page:
Business Context Integrations Interface

This page provides access to configure and manage integrations with your Business Contexts tools.

The list of integrations will indicate whether there are any active integrations or if the tools are not yet integrated. Active integrations will be marked accordingly, allowing you to easily identify the current status of each integration.

How the Integration Works​

  1. Admin API Key Creation

    • Create an Admin API key in the OpenAI platform with read-only permissions
    • Securely store and provide this key to nOps during integration setup

  2. Integration Setup

    • Enter a descriptive API Key Name for identification purposes
    • Configure the OpenAI Admin API Key in nOps
    note

    Make sure to keep your API key secure and never share it with unauthorized users.

  3. Data Retrieval by nOps

    • nOps uses the provided Admin API key to fetch billing and usage data from OpenAI
    • Data is collected for all services associated with your OpenAI account

  4. Data Processing

    • The retrieved data is processed and displayed within the Business Context+ product
    • Cost information is organized by service type, model, and time period

Step 1: Create an Admin API Key in OpenAI​

Admin API keys are required for secure access to your OpenAI billing data.

  1. Access Admin API Key Settings

  2. Set Admin API Key Parameters

    • Enter a descriptive name (e.g., "nOps Integration")
    • Select Read-only permissions
    • Click Create admin key
    important

    For security reasons, we recommend setting an expiration date for your Admin API key. You can create a new key and update the integration before the current key expires.

  3. Save Admin API Key

    • Copy the generated Admin API key
    • Store it securely—Admin API keys are shown only once
    caution

    Do not share your Admin API key or expose it in public repositories. If the Admin API key is lost, you'll need to generate a new one and update the integration.

Step 2: Set Up Integration in nOps​

  1. Access the Business Context+ Integrations page to begin.
  2. Select the OpenAI integration card.
  3. Click on the +Add OpenAI Integration button

Configuration Parameters​

  1. Enter API Key Name

    • Provide a descriptive name for this integration (e.g., "Marketing Team OpenAI" or "Development OpenAI")
    • This helps identify the integration if you have multiple OpenAI accounts

  2. Enter Admin API Key

    • Paste the Admin API key you copied from the OpenAI platform

  3. Click Setup to finish

    important

    Double-check your Admin API key. Incorrect entries will prevent synchronization.

Step 3: Verify Integration​

After setting up the integration, you should see it listed in your active integrations.

  1. Wait for Data Synchronization

    • It may take up to 24 hours for the initial data to appear
    • After synchronization, you can access your OpenAI cost data in the Cost Analysis section

  2. Access Cost Data

    • Navigate to the Cost Analysis tool
    • Look for OpenAI as a service provider in your cost breakdowns
    • Filter and analyze costs by model, service type, and time period

Managing Multiple Integrations​

If you need to track costs for multiple OpenAI accounts or projects:

  1. Create Separate Admin API Keys

    • Generate a unique Admin API key for each OpenAI account
    • Ensure each key has the appropriate permissions

  2. Set Up Additional Integrations

    • Follow the same process to add each integration
    • Use distinct, descriptive names for each integration to easily identify them

  3. View Consolidated Data

    • All OpenAI integrations will contribute data to your cost analysis
    • Use filters and tags to differentiate between different accounts or projects

Troubleshooting​

  1. Admin API Key Issues

    • Verify the key has not expired
    • Ensure it has read permissions for billing data
    • Check for typos in the Admin API key

  2. Data Not Appearing

    • Allow up to 24 hours after setup
    • Confirm there is actual billing activity in your OpenAI account
    • Verify the Admin API key is still active in OpenAI

  3. Incomplete Data

    • Ensure the Admin API key has access to all relevant OpenAI services
    • Check if there are any usage limits on your OpenAI account

For support, contact nOps with your API Key Name (not the actual key) and any error messages you've encountered.